home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / rabi_132.zip / RABI.DOC < prev    next >
Text File  |  1991-05-28  |  20KB  |  440 lines
  1.  
  2. ──────────────────────────────────────────────────────────────────────────────
  3.  
  4.                          for RA 1.0 and higher only !
  5.  
  6.                   │███████│    │██████│    │███████│   │██│        
  7.                  │██│   │██│  │██│  │██│  │██│   │██│  │██│        
  8.                  │██│   │██│        │██│  │██│   │██│  │██│        
  9.                  │████████│    │███████│  │████████│   │██│        
  10.                  │██│ │██│    │██│  │██│  │██│   │██│  │██│        
  11.                  │██│  │██│   │██│  │██│  │██│   │██│  │██│        
  12.                  │██│   │██│  │██│  │██│  │██│   │██│  │██│        
  13.                  │██│    │██│  │██████│    │███████│   │██│ v1.32
  14.  
  15.                        RABI, THE RemoteAccess Bimodem Shell
  16.                             Released May-28-1991
  17.                  (c) Copyright Ron Huiskes/InterSoft 1990 - 1991
  18.                               All Rights Reserved 
  19.  
  20.  
  21. ──────────────────────────────────────────────────────────────────────────────
  22.  ▓ INTRODUCTION
  23. ──────────────────────────────────────────────────────────────────────────────
  24.  
  25.  
  26.   Bimodem is a great program ! Every sysop should have it installed
  27.   on his bbs to offer the great advantages to the users of uploading
  28.   and downloading at the same moment.
  29.  
  30.   Bimodem is very easy to install in RemoteAccess, but then not every
  31.   limit and security can be controlled. And here is were RABI comes
  32.   in the picture. RABI is a bimodem shell for RemoteAcces. It uses all
  33.   the features Bimodem has, but keeps in mind the limits of the user.
  34.  
  35.  
  36. ──────────────────────────────────────────────────────────────────────────────
  37.  ▓ FEATURES OF RABI
  38. ──────────────────────────────────────────────────────────────────────────────
  39.  
  40.  
  41.   ■ RABI can be used as stand-alone door in RA, or it can be installed
  42.     as external protocol in config.ra.
  43.  
  44.   ■ RABI keeps control over the users time limit; users are returned
  45.     to the bbs when their time limit is exceeded. 
  46.  
  47.   ■ RABI keeps control over the users download limit, and will refuse
  48.     any download after this limit is reached. 
  49.  
  50.   ■ RABI keeps control over the directories a user has access to.
  51.  
  52.   ■ RABI keeps control over the descriptions of a file if a user
  53.     omit this when uploading.
  54.  
  55.   ■ RABI updates the users record number immediately after return to
  56.     the Bbs, the user can see directly was has happened. Only
  57.     succesfull down- and uploads will be recorded.
  58.  
  59.   ■ Users can enter files to download on-line in RABI, before executing
  60.     Bimodem on the Bbs ala filedoor, including wildcards and sysop 
  61.     definable default extension. (stand alone mode)
  62.  
  63.   ■ Full ANSI/ANSI MUSIC/AVATAR support, no ansi.sys required at sysops site.
  64.  
  65.   ■ DesqView Aware, gives up timeslices when detected, and using
  66.     bios writes when the directscreen toggle in raconfig is off.
  67.  
  68.   ■ Sysop definable hot Keys when using the menu shell.
  69.  
  70.   ■ Support for Ra's internal ratio system. If enabled RABI refuses
  71.     any download if the ratio of the user is not correct.
  72.  
  73.   ■ The name, location, baudrate, security level and timeleft are printed
  74.     under Bimodem, so you can exactly see who is online.    
  75.  
  76.   ■ RABI can make his own logfile if you want, AND logs every
  77.     succesfull transfer in the Ra.Log file (frontdoor or opus) including
  78.     filesize and cps rate.
  79.    
  80.   ■ When using stand alone mode the look of RABI is controlled by an
  81.     ascii/ansi textfile, which you can edit as you like. You can even
  82.     use control codes in it !
  83.  
  84.   ■ RABI has smart fossil functions and carrier detect routines.
  85.  
  86.   ■ Users can upload private files.
  87.  
  88.   ■ RABI can update your download counters in files.bbs. (stand alone only)
  89.      
  90.  
  91. ──────────────────────────────────────────────────────────────────────────────
  92.  ▓ BIMODEM INSTALLATION
  93. ──────────────────────────────────────────────────────────────────────────────
  94.  
  95.      
  96.   First, make sure you installed Bimodem correctly.  In the
  97.   FILENAMES AND PATHS section in the biconfig program there is
  98.   a line with: "Path of file listing directories that determine
  99.   rejections". Let this point to an ascii file with on every line
  100.   ALL your download directories in it. (Including the protected
  101.   ones for special users).
  102.  
  103.   There is another line with "Directory that files will be sent from."
  104.   This must point to another ascii file name. Make sure it contains a 
  105.   valid path. You don't have to make the file, RABI will make this at
  106.   every  start. It contains all the directory paths to which the user
  107.   has access to (from files.ra).
  108.  
  109.  
  110. ──────────────────────────────────────────────────────────────────────────────
  111.  ▓ BIMODEM'S SECURITY
  112. ──────────────────────────────────────────────────────────────────────────────
  113.  
  114.  
  115.   To maintain the best possible security over your files and directories
  116.   it is essential that you set the following opties exactly the same
  117.   in your bimodem.cfg file:
  118.                                                 
  119.                        General Options           
  120.                                                                          
  121.  ╔══════════════[BiConfig - (C) Copyright Erik Labs 1989]═════════════╗  
  122.  ║   These options dictate what will be allowed when people           ║  
  123.  ║   request files from or send files to YOUR system                  ║  
  124.  ║                                                                    ║  
  125.  ║   Allow current directory access (Y/N)          N   !              ║  
  126.  ║   Allow file names only (no paths) (Y/N)        Y   !              ║  
  127.  ║   Rename the file if it already exists (Y/N)    N                  ║  
  128.  ║   Always verify when done (Y/N)                 Y                  ║  
  129.  ║   Do NOT allow source deletion (Y/N)            Y   !              ║  
  130.  ║   Retain original file date (Y/N)               N                  ║  
  131.  ║   Do NOT allow full directory transfers (Y/N)   Y   !              ║  
  132.  ║   Do NOT allow sub directory transfers (Y/N)    Y   !              ║  
  133.  ║   Replace Timer Interrupt (Y/N)                 N                  ║  
  134.  ║   Replace Keyboard Interrupt (Y/N)              N                  ║  
  135.  ║   Allow remote file requests (Y/N)              Y   !              ║  
  136.  ║   Allow local file requests (Y/N)               Y   !              ║  
  137.  ║                                                                    ║  
  138.  ╚════════════════════[    Esc-Exit,Tab,BTab    ]═════════════════════╝  
  139.                                                                          
  140.                        Upload / Download Defaults                   
  141.                                                                            
  142.  ╔══════════════[BiConfig - (C) Copyright Erik Labs 1989]═════════════╗   
  143.  ║                                                                    ║   
  144.  ║   These are the default settings that will be used when            ║   
  145.  ║   you request a file to be sent TO your computer                   ║   
  146.  ║                                                                    ║   
  147.  ║                                                                    ║   
  148.  ║   If file exists, use verify to upload it (Y/N)      Y             ║   
  149.  ║                                                                    ║   
  150.  ║   If file exists, replace it (Y/N)                   N   !         ║   
  151.  ║                                                                    ║   
  152.  ║   Verify files when done transferring (Y/N)          N             ║   
  153.  ║                                                                    ║   
  154.  ║   Delete source file when done (Y/N)                 N   !         ║   
  155.  ║                                                                    ║   
  156.  ║   Include matching files in sub directories (Y/N)    N   !         ║   
  157.  ║                                                                    ║   
  158.  ╚════════════════════[    Esc-Exit,Tab,BTab    ]═════════════════════╝   
  159.  
  160.  
  161.   Only with these settings Rabi will perform 100%.
  162.                                                                            
  163.  
  164. ──────────────────────────────────────────────────────────────────────────────
  165.  ▓ RABI INSTALLATION
  166. ──────────────────────────────────────────────────────────────────────────────
  167.  
  168.  
  169.   RABI assumes the following:
  170.  
  171.   - That you have set the RA environment variable to point to
  172.     your system dir (where config.ra en files.ra are in).
  173.  
  174.   - That you have installed bimodem correctly (see above).
  175.  
  176.   - That RABI can find Dorinfo1.def and Exitinfo.bbs in the
  177.     current dir.
  178.  
  179.   - That the RABI cfg file (RABI.CFG) is in the current dir.
  180.     (This can be overruled with the /C<rabicfgfile> parameter.
  181.  
  182.  
  183. ──────────────────────────────────────────────────────────────────────────────
  184.  ▓ RABICFG.EXE
  185. ──────────────────────────────────────────────────────────────────────────────
  186.  
  187.  
  188.   The RABICFG.EXE program is the configuration program for RABI. It
  189.   creates the necessary RABI.CFG file. With it you can control the
  190.   look and actions RABI takes.
  191.  
  192.   Most functions are not working when RABI is installed in protocol.ra,
  193.   but an RABI.CFG must exist.
  194.  
  195.   If you want to call the configuration file something else as the
  196.   hardcoded 'RABI.CFG' name, you can supply the parameter /C<filename>
  197.   when Rabi is started.
  198.  
  199.   When you start RABICFG you have to fill in the path (and name) to your
  200.   bimodem.com and bimodem.cfg file. 
  201.  
  202.   On the third line you can give the path and name to a ascii/ansi/avatar
  203.   file which can be used as a menu. This file will be displayed when the
  204.   user enters RABI, to start the different options in RABI. (stand alone
  205.   only)
  206.  
  207.   On the fourth and fifth line you can supply two other ascii/ansi/avatar
  208.   files which will be displayed when the user presses the hotkeys in the
  209.   menu shell. (stand alone only)
  210.  
  211.   On the last line of the first block you can supply a special logfile for
  212.   RABI. RABI itself is also hardcoded to write to your normal ra log, so
  213.   use this only if you want RABI to make a separate log. If you don't want
  214.   RABI to create a special log, just leave this line blank. 
  215.  
  216.   On the next set of lines you can change the colors RABI uses (just press
  217.   enter, and a box with options will be displayed), if RABI must update your
  218.   download counters, what default file extension it must use, and wether or
  219.   not you want RABI to ask if the user wants to hangup after transfers. 
  220.   Here you can also enable the option to let RABI check the ratios of the
  221.   user (depending on limits.ctl).
  222.  
  223.   The last set of lines can be used to change the hotkeys in the menu shell.
  224.   If you want to start bimodem directly when RABI is envoked, make all the
  225.   hotkeys blank (spaces), and RABI will start bimodem directly without using 
  226.   the menu shell. (stand alone only)
  227.  
  228.  
  229. ──────────────────────────────────────────────────────────────────────────────
  230.  ▓ INSTALLING RABI AS A SEPERATE DOOR
  231. ──────────────────────────────────────────────────────────────────────────────
  232.  
  233.  
  234.   In a users point of view this methode is the prefered way. Users can
  235.   choose themself how they want to start Bimodem and what they want to
  236.   down and/or upload.
  237.  
  238.   Installing RABI as a seperate door in RemoteAccess is like most other
  239.   doors. RABI doesn't need any parameters and as long as you have set
  240.   everything correctly in RABI.CFG your door will run without a problem.
  241.  
  242.   In the optional datafield in your menu you just put the complete path
  243.   and name of RABI (including extension) and you are ready to go. (type 7).
  244.  
  245.   When you log on to your board locally you can check if RABI works 
  246.   correctly. Offcourse bimodem will not start because their is no
  247.   carrier...
  248.  
  249.  
  250. ──────────────────────────────────────────────────────────────────────────────
  251.  ▓ INSTALLING RABI IN PROTOCOL.RA
  252. ──────────────────────────────────────────────────────────────────────────────
  253.  
  254.  
  255.  Well, after rewriting RABI's source code RABI can now also be installed
  256.  in protocol.ra. RA (and RABI) will update the users limits correctly, and
  257.  users can still add files for up/download with the ALT-A key in bimodem.
  258.  
  259.  To behave correctly from Protocol.ra you must set an 'DSZLOG' environment
  260.  variable to point to a logfile name. This file is used by RA to update
  261.  the users limits correctly. Just place 'SET DSZLOG=C:\RA\DSZ.LOG' or
  262.  something simular in your autoexec.bat.
  263.  
  264.  In your protocol.ra, find a free slot, and fill in all the field as
  265.  follows: (replace the paths to RABI and your DSZ.LOG according to
  266.  your own setup)
  267.  
  268.                                                                           
  269.  Name                  : BiModem                            <- own choice  
  270.  Key                   : B                                  <- own choice  
  271.  Extended control file : No                                 <- better not  
  272.  Batch available       : Yes                                <- yes please  
  273.  Status                : Always available                   <- sure        
  274.  Log file name         : c:\ra\DSZ.LOG             <- dszlog environment   
  275.  Control file name     : files.lst                          <- hardcoded   
  276.  Download command line : c:\ra\doors\RABI.EXE /D   <- parameter hardcoded  
  277.  Upload command line   : EXIT             
  278.  Download ctl string   : @                                  <- hardcoded   
  279.  Upload ctl string     :                        
  280.  Download log keyword  : DL-B                               <- hardcoded   
  281.  Upload log keyword    :                                   
  282.  Log : Name word #     : 1                                  <- hardcoded   
  283.  Log : Desc word #     :                                                   
  284.                                                                            
  285.  
  286.  At this time RABI can only be started for Downloading (offcourse users
  287.  can add files for uploading). In the future also Uploading will be
  288.  implemented. 
  289.  
  290.  
  291. ──────────────────────────────────────────────────────────────────────────────
  292.  ▓ CONTROL CODES
  293. ──────────────────────────────────────────────────────────────────────────────
  294.  
  295.  
  296.   In the ascii/ansi/avatar files RABI uses when installed as a seperate
  297.   door you can use control codes to make the output of your choice. The
  298.   following are valid: 
  299.  
  300.   ^A   :  Pauses and wait for a key
  301.   ^FA  :  Users full name
  302.   ^FB  :  City
  303.   ^FO  :  Security level
  304.   ^FP  :  Calls to the Bbs
  305.   ^FQ  :  Number of Uploads
  306.   ^FR  :  Kilobytes of downloads  
  307.   ^FS  :  Number of Downloads
  308.   ^FT  :  Kilobytes of uploads                               
  309.   ^FW  :  First name only
  310.   ^KO  :  Minutes remaining today
  311.   ^KT  :  Daily download limit (in K)
  312.  
  313.  
  314. ──────────────────────────────────────────────────────────────────────────────
  315.  ▓ BEHAVIOUR
  316. ────────────────────────────────────────────────────────────────────────────── 
  317.  
  318.  
  319.   RABI has smart fossil and carrier detect routines. Don't worry about any-
  320.   thing. Is a user drops the carrier, Bimodem returns to RABI, and RABI 
  321.   immediately returns to the BBS. (After updating the user record, hehe :-)
  322.    
  323.   RABI will log every succesfull transfer in your logfile as specified in
  324.   Config.Ra. Also, RABI can make it's own logfile if you wish as specified
  325.   in the RABI.CFG file. In it every transfer is logged, also the ones that
  326.   the user aborted. If there by any change occurs an error, the online error
  327.   message will also be logged into this logfile.  RABI will only update the
  328.   users down and upload fields if they were succesfull transfered. If a file
  329.   is aborted or not found RABI does not take credit for it. (But a resumed
  330.   filetransfer will be credited.) RABI uses FILES.RA to find out to which
  331.   areas the user has access to, and passes them over to Bimodem.
  332.  
  333.  
  334. ──────────────────────────────────────────────────────────────────────────────
  335.  ▓ RATIO SYSTEM
  336. ────────────────────────────────────────────────────────────────────────────── 
  337.  
  338.  
  339.   The ratio system in Rabi is exactly the same as in Ra. If enabled RABI
  340.   will examine limits.ctl in your Ra system path and will refuse any
  341.   download if the users ratio is not correct.
  342.  
  343.   When the ratio system is enabled, make sure you have a RATIO.A* and
  344.   RATIOK.A* file in your textfile dir as set in raconfig. This will 
  345.   displayed to the user if he tries to enter filesnames online in Rabi.
  346.  
  347.  
  348. ──────────────────────────────────────────────────────────────────────────────
  349.  ▓ DISCLAIMER
  350. ──────────────────────────────────────────────────────────────────────────────
  351.  
  352.   - Legal mode on -
  353.  
  354.   The RABI package is supplied as is. The author disclaims all warranties,
  355.   expressed or implied, including, without limitation, the warranties of
  356.   merchantability and of fitness for  any purpose. The author assumes no
  357.   liability for damages, direct or consequential, which may result from
  358.   the use of RABI.
  359.  
  360.   RABI is a "shareware program" and is provided at no charge to the user
  361.   for evaluation. The essence of "user-supported" software is to provide
  362.   personal computer users with quality software without high prices, and
  363.   yet to provide incentive for programmers to continue to develop new
  364.   products.
  365.  
  366.   You are hereby granted a temporary license to use RABI for say 30 days
  367.   for evaluation. If you continue to use RABI after these 30 days you
  368.   need to register the software in order to get a permanent license.
  369.  
  370.   The RABI package, all programs, the documentation and support files
  371.   are copyrighted 1990-1991 by Ron Huiskes / InterSoft. All rights are
  372.   reserved. You may copy  this package for backup  purposes. You may also
  373.   copy and share unmodified copies of the whole package, providing that
  374.   the copyright notice is reproduced and included on all copies.
  375.  
  376.   -Legal mode off-
  377.  
  378. ──────────────────────────────────────────────────────────────────────────────
  379.  ▓ REGISTERING
  380. ────────────────────────────────────────────────────────────────────────────── 
  381.  
  382.  
  383.   Regarding the time and effort i have put into this product, the
  384.   registration is simple and rather cheap.
  385.  
  386.   Payment of the registration fee, entitles you to:
  387.  
  388.     - The license for running one copy of the RABI-package on any
  389.       computer in a bbs system, including multiline sytems that
  390.       share the same file system 
  391.  
  392.     - A serial key that makes your copy of Rabi licensed to you.
  393.       This key file will work on every new version in the future.
  394.  
  395.   The price for a registration license is DFL 15,-
  396.  
  397.   After registering you receive a RABI key file that under no circumstances
  398.   must be made available to someone else.
  399.  
  400.   Why register ?
  401.  
  402.   Well, simpel: I think that if you can afford a BBS, a computer, a modem
  403.   and probably echoMail, then you also can afford to pay the software that
  404.   you use...
  405.  
  406.   Thank You for Your support.
  407.  
  408.  
  409.   Users who want to register Rabi and live outside of Europe can contact
  410.   Scott Livingston in the US to register Rabi:
  411.  
  412.         Scott Livingston
  413.         290F Brittany Farms Rd
  414.         New Britain, CT 06053 
  415.         USA
  416.  
  417.         Phone Henge BBS  203-826-1153
  418.  
  419.  
  420. ──────────────────────────────────────────────────────────────────────────────
  421.  ▓ MORE QUESTIONS ?
  422. ────────────────────────────────────────────────────────────────────────────── 
  423.  
  424.  
  425.  If you have any questions, bug reports, bomb letters, or anything else
  426.  you like to get ride of: 
  427.  
  428.                           Ron Huiskes / Bbs Interface
  429.                                  P.o. Box 528
  430.                                2280 AM Rijswijk
  431.                                    Holland
  432.                          
  433.                         +31-70-3361380 / +31-70-3361381
  434.          
  435.                             [2:281/506@fidonet.eur] 
  436.  
  437. ──────────────────────────────────────────────────────────────────────────────
  438. <EOF>
  439.  
  440.